home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Utilities / Unix / cvs-960311 / NeXT-cvs-README next >
Text File  |  1996-01-11  |  5KB  |  75 lines

  1. cvs environment for use with the NEXTSTEP java porting effort
  2.  
  3. Maintained by:     Bill Bumgarner <bbum@friday.com>
  4. Lots of Assistance:     Vince DeMarco 
  5.  
  6. Release Notes #1
  7.  
  8. This is a bug fix release.  The initial release contained a bug in the rcs binaries;  they included a hard-coded path to /bin/diff.   /bin/diff is the diff distributed with NEXTSTEP.  It is incompatible with cvs and rcs.  rcs has been recompiled using /usr/local/cvs/bin as the source of the diff binaries.
  9.  
  10. patch and a new version of cvs have both been included in this release.
  11.  
  12. To update your existing cvs environment, replace the existing contents of /usr/local/cvs with the contents of the new archive (for this reason, your source repository cannot reside in /usr/local/cvs-- if it does, move it out of the way first!).  Once installed, evaluate 'cvsinit' to install the new template files-- this should not adversely alter your existing cvs environment.
  13.  
  14. The version information contained within this documentation has been changed to reflect the versions now distributed with the package.
  15.  
  16. Introduction
  17.  
  18. cvs provides an extremely powerful system for managing revision control across many software projects that may be in active development by multiple developers.  There is nothing terribly NEXTSTEP/Java centric about the release;  it was thrown together to fulfill the needs of the porting effort.   Since no effort has been made to properly support the NEXTSTEP development environment beyond the command line (nib files, etc), the title of this document and the context of the packages release has been tied to Java as a reminder of its incompleteness.
  19.  
  20. What is included in this package?
  21.  
  22. The archive includes quad-fat builds of rcs,cvs, and diff-- all software from the GNU archive sites.  Because cvs hard-wires some of the paths internally, the contents of the archive must be installed in /usr/local/cvs.
  23.  
  24. 6-wellington % diff -v
  25. diff - GNU diffutils version 2.7
  26. 7-wellington % cvs -v
  27.  
  28. Concurrent Versions System (CVS) 1.6.85 (client/server)
  29.  
  30. Copyright (c) 1993-1994 Brian Berliner
  31. Copyright (c) 1993-1994 david d `zoo' zuhn
  32. Copyright (c) 1992, Brian Berliner and Jeff Polk
  33. Copyright (c) 1989-1992, Brian Berliner
  34.  
  35. CVS may be copied only under the terms of the GNU General Public License,
  36. a copy of which can be found with the CVS distribution kit.
  37. 8-wellington % rcs -V
  38. RCS version 5.7
  39. 9-wellington % patch -v                                                       
  40. Patch version 2.1
  41.  
  42. The archive includes all of the man pages, info pages, library resources, and binaries installed by the three packages.  Also included are postscript cvs documentation files.  /usr/local/cvs/bin, /usr/local/cvs/man, and /usr/local/cvs/info should be added to the PATH, MANPATH, and emacs info environment respectively.
  43.  
  44. The CVS version number listed above does not tell the whole story.  The version included in the package was built from the beta development tree released on January 5, 1996.
  45.  
  46. Setting up a repository
  47.  
  48. Before you can use cvs, you must create a repository within which cvs will keep track of all project resources.   The program cvsinit is provided for this purpose.  To use, first set the environment variable CVSROOT to point to the directory within which the cvs repository will be stored.  This directory should be empty and should be on a volume with a reasonable amount of free disk space.
  49.  
  50. For example,  for those using zsh, the following lines can be added to ~/.zshenv to make /LocalDeveloper/Repository/cvs the default cvs repository:
  51.  
  52. CVSROOT=/LocalDeveloper/cvs
  53. export CVSROOT
  54.  
  55. Once the CVSROOT environment variable is set, execute cvsinit.  cvsinit will copy template configuration files from /usr/local/lib/cvs into $(CVSROOT)/CVSROOT/.
  56.  
  57. How to use cvs
  58.  
  59. Pascal Molli has an excellent web page summarizing all the various cvs related materials available via the internet.   It is an excellent starting place for learning about cvs.
  60.  
  61. http://www.loria.fr/~molli/cvs-index.html
  62.  
  63. Maintenance, Bugs, Support, Etc.
  64.  
  65. Formally, this package is completely unsupported.  It was thrown together to support the NEXTSTEP/OpenStep Java Porting effort.  If you have any problems, questions, suggestions, additions, please send them to <bbum@friday.com>.  Updates will be sporadically released as bugs are fixed, features are added, and the various software packages are updated.
  66.  
  67. The latest version of this package can always be found on the ThoughtPort Authority ftp site:
  68.  
  69. ftp://ftp.thoughtport.com/pub/next/tools
  70. ftp://ftp.thoughtport.com/pub/next/tools/NeXT-cvs.b.SHIN.tar.gz
  71.  
  72. ThoughtPort has been kind enough to provide the space and connectivity that made the creation and distribution of this package possible.  If are looking for connectivity or network production services (content and connectivity), visit ThoughtPort's web site for information:
  73.  
  74. http://www.thoughtport.com/
  75.